home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 6: Level 6 / 17 Bit - Level 6 (1998)(Epic Marketing)[!].iso / quartz / p214.dms / p214.adf / PPShow.doc / PPShow.doc
Text File  |  1992-04-30  |  14KB  |  322 lines
  1.  
  2.  
  3.                             PPShow 2.0 User Manual
  4.  
  5.                                  Sep 22, 1991
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12. The programs and files in this distribution are freely distributable, but are
  13. also copyright (c) Nico François.  They may be freely distributed as long as
  14. no more than a nominal fee is charged to cover time and copying costs.
  15.    No commercial usage is permitted without written permission from the
  16. author.  Everything in this distribution must be kept together, in original
  17. unmodified form.
  18.  
  19.  
  20.    Coverdisks or diskmagazines need written permission of UGA to offer the
  21. Powerpacker utilities or Powerpacker/Reqtools libraries on their disk. For
  22. commercial use please read the copyright file on your original PP disk.
  23.  
  24.  
  25.    The above is generally known as freeware.
  26.  
  27.    If you have suggestions or remarks about this program, or if you find
  28. any bugs, please let me know.
  29.  
  30.    Write to the following address:
  31.  
  32.                                 Nico François
  33.                                 Corbielaan 13
  34.                                 B-3060 Bertem
  35.                                 BELGIUM
  36.  
  37.    PPShow 2.0 requires AmigaDOS Release 2 (Kickstart & Workbench 2.0) to run.
  38.  
  39.  
  40. Contents
  41. ========
  42.  
  43. 1. An introduction
  44.  
  45. 2. Usage
  46.  
  47. 3. Features
  48.  
  49. 4. Note on crunching
  50.  
  51.  
  52. 1. An introduction
  53. ==================
  54.  
  55.    PPShow was written to complement one of my other utilities, PowerPacker
  56. (a command and data cruncher).  It is used to show normal IFF ILBM files or
  57. ILBM files crunched with PowerPacker.  The decrunching is done automatically
  58. so the user doesn't have to know if a file is crunched or not.
  59.  
  60.    PPShow uses 'powerpacker.library' and 'reqtools.library', so make sure
  61. these are present in your Libs: directory.  Double-click 'Install_libs' for
  62. an automatic installation.
  63.  
  64.    If you haven't got PowerPacker you are of course missing one of the main
  65. features of this program.  PowerPacker is available as shareware (up to
  66. version 2.3b) or as a commercial program (version 4.0a).  Order a copy from
  67. UGA, P.O.Box 881, 3700 AW Zeist, The Netherlands.  The commercial version
  68. offers several enhancements like 40 to 50 times faster crunching, overlay
  69. support, an ARexx port, and much more.
  70.  
  71.  
  72. 2. Usage
  73. ========
  74.  
  75.    PPShow can be used in several different ways.
  76.  
  77. - First of all via the CLI:
  78.  
  79.    If you enter 'PPShow ?' you will get a standard AmigaDOS usage template,
  80. enter 'PPShow ??' for more information.  You use PPShow like this:
  81.  
  82.    PPShow {<file|dir>} [LO] [HI] [SHI] [PROD] [L=LACE] [NL=NOLACE] [HAM]
  83.                        [TIME s] [NOCYCLE] [NO=NOOVERSCAN] [A2024 [15Hz]]
  84.                        [PAL] [NTSC] [VGA] [LOOP]
  85.  
  86.    The program will by default load the specified ILBM file and display it.
  87. If the file was crunched using PowerPacker 2.0 or higher PPShow will first
  88. decrunch it for you.  If the file was encrypted you will be prompted for the
  89. password.  You may specify more than one file on the command line and you may
  90. even use wildcards, PPShow will show all files one at a time, double buffering
  91. the display.
  92.  
  93.    If you enter PPShow without options, you will be presented with a
  94. filerequester.  Entering PPShow with a directory instead of a file as an
  95. argument will also get you a requester, but it will be positioned in the
  96. directory you specified.
  97.  
  98.    There are several command line options:
  99.  
  100.      LO         : Force screen to open in LORES        mode.
  101.      HI         :   ''    ''    ''   ''   HIRES         ''
  102.      SHI        :   ''    ''    ''   ''   SUPERHIRES    ''
  103.      PROD       :   ''    ''    ''   ''   PRODUCTIVITY  ''
  104.      LACE       : Force interlace on.
  105.      NOLACE     : Force interlace off.
  106.      HAM        : This switch is used to select HAM mode when no CAMG chunk
  107.                   is found.  If you don't specify this switch PPShow will
  108.                   assume a 6 plane screen is extra-halfbrite. Note that this
  109.                   switch does not force HAM mode, it merely instruct PPShow
  110.                   to use HAM mode in case of doubt.
  111.      TIME s     : Display pictures for 's' seconds.
  112.      NOCYCLE    : Do not start cycling automatically.
  113.      NOOVERSCAN : Disable overscan.
  114.      LOOP       : Display all pictures in a loop, press CTRL-D to abort.
  115.      PAL        : Use 'pal.monitor'.
  116.      NTSC       : Use 'ntsc.monitor'.
  117.      VGA        : Use 'multiscan.monitor'. Please note that when using VGA,
  118.                   LO puts the screen in EXTRALORES, HI in LORES and SHI in
  119.                   PRODUCTIVITY (same as PROD).
  120.      A2024      : Use 'a2024.monitor'.
  121.      15Hz       : Put A2024 monitor into 15Hz, rather than 10Hz.
  122.  
  123.    PPShow can be made resident so it doesn't have to be loaded every time
  124. you use it, use the c: Resident command for this.  You can't make PPShow
  125. resident when it is crunched!!  The file is supplied as an uncrunched command
  126. file with the pure bit set.  PPShow is reentrant as well, so you can run it
  127. from several CLI's at the same time.  (Not that this is very useful, but it's
  128. possible :-)
  129.  
  130.    Examples:
  131.  
  132.     o PPShow dh0:pics/HAMpicWithoutCAMG.pic HAM
  133.  
  134.     o PPShow dir/#?.pic TIME 5 LOOP
  135.  
  136.        Show all files in directory 'dir' with a '.pic' suffix for 5 seconds
  137.        and loop until user presses CTRL-D.
  138.  
  139.     o PPShow PICS:~(#?.info) NOOVERSCAN
  140.  
  141.        Show all files on 'PICS:' NOT ending in '.info'. Disable overscan.
  142.  
  143.  
  144. - Via the WorkBench:
  145.  
  146.    There are three different ways of using PPShow via the workbench: you
  147. can set the default tool of the (crunched) ILBM file to 'PPShow', you can
  148. single click the PPShow icon and then extend-select one or more picture icons
  149. (use shift click, double-clicking the last one) or you can double-click the
  150. PPShow icon and specify a filename using the filerequester.
  151.    You set the default tool by single clicking the icon of the picture and
  152. selecting 'Information' from the 'Icons' menu.  You will get a window with
  153. several gadgets in it, click in the string gadget where it says 'Default tool'
  154. and enter ':ppshow'.  PPShow should be in the root directory of your disk for
  155. this to work, if e.g.  it's in the system directory you should enter
  156. ':system/ppshow'.  Last of all select the 'Save' gadget.
  157.  
  158.    Following tooltypes are recognized by PPShow (in the pictures' icon, not
  159. PPShow's icon):
  160.  
  161.      HAM        : See CLI option.
  162.      TIME=s     : Display picture for 's' seconds.
  163.      NOCYCLE    : Do not start cycling automatically.
  164.      NOOVERSCAN : Disable overscan.
  165.  
  166.  
  167. NOTE: - Follow these steps to make a simple slideshow that runs by double-
  168.         clicking an icon:  Make a script file containing something like the
  169.         following line: 'PPShow #?.pic TIME 10 LOOP'.  Set this script's
  170.         default tool to 'c:IconX' and enter 'WINDOW=CON://///AUTO' in its
  171.         tooltypes.  Put the script in a directory containing pictures (all
  172.         ending in '.pic'!).  If you now double-click this scripts icon the
  173.         slideshow will start, press ESC or CTRL-D to end.
  174.       - PPShow will add '.pp' to the filename when the file wasn't found.
  175.         This is very useful in the Workbench enviroment: you can make an
  176.         icon for 'house.pic' but name the file 'house.pic.pp'.  Now the
  177.         WorkBench will show an icon with 'house.pic' as name, but if you
  178.         doubleclick it 'house.pic.pp' will be displayed. (As long as there
  179.         is no 'house.pic' file in the directory!)
  180.       - Drag as many monitor icons to the WbStartup drawer as your monitor
  181.         allows.  For example: if you have a multiscan monitor drag pal, ntsc
  182.         and multiscan.monitor to your WbStartup drawer.  If you do this you
  183.         will have maximum ease of use of PPShow.
  184.  
  185.  
  186. 3. Features
  187. ===========
  188.  
  189.    - Abort PPShow by pressing 'Q', CTRL-C or the right mouse button.  Press
  190.      CTRL-D to abort everything and to break a script.  The screen can be
  191.      dragged by pressing LEFT-AMIGA, holding down the left mouse button and
  192.      moving the mouse (you may have to press something else than LEFT-AMIGA,
  193.      depending on your 'IControl' preferences settings).
  194.  
  195.    - PPShow offers full overscan and monitor support: PAL, NTSC, VGA, A2024.
  196.  
  197.    - PPShow can be used as a simple slideshow tool.  It supports wildcards
  198.      to simplify this.
  199.  
  200.    - Deluxe Paint color cycling is supported, press <TAB> to (de)activate.
  201.      Up to 8 cycles are supported (DPaint III currently only supports 6).
  202.  
  203.    - The pesky little mouse will be removed while displaying.  Press 'M' to
  204.      toggle the mouse pointer on/off.
  205.  
  206.    - Press 'L' to load another picture, you will be presented with the
  207.      filerequester.
  208.  
  209.  
  210. 4. Note on crunching
  211. ====================
  212.  
  213.    A lot of IFF ILBM files are already crunched with the standard ByteRun1
  214. compression.  PowerPacker will crunch these files even further (most of the
  215. time) but will not crunch them as well as uncrunched ILBM files.  So save IFF
  216. files uncrunched (if you can, e.g. with PixMate) before crunching them, this
  217. way you will get the best crunching results.
  218.  
  219.  
  220.                         As always, I hope you find this program useful!
  221.  
  222.  
  223.                               PROGRAM HISTORY:
  224.  
  225. *****************************************************************************
  226. VERSION 1.0
  227.  
  228.      First release.
  229.  
  230. *****************************************************************************
  231. VERSION 1.1
  232.  
  233.      Decrunching is about 40% faster (accidently used slow decruncher in 1.0)
  234.      Screen now pops to front when picture is ready to be viewed, not before.
  235.      Filerequester used when arp.library is available.
  236.      'L' command added to load other pictures without restarting PPShow.
  237.  
  238. *****************************************************************************
  239. VERSION 1.1a
  240.  
  241.      The Guru isn't with me lately, after using a slow decruncher in 1.0
  242.        by accident I now used a fast but faulty decruncher in 1.1. It
  243.        sometimes didn't decrunch correctly, this has now been fixed. The
  244.        decruncher is still 40% faster than the 1.0 one. (and it's 2 bytes
  245.        shorter :^D )
  246.  
  247. *****************************************************************************
  248. VERSION 1.2
  249.  
  250.      Rewrote cycling routine in assembly, so less overhead when cycling.
  251.      Uses the all new powerpacker.library => shorter code.
  252.      Starting PPShow from the CLI with a directory as an argument now puts
  253.        up the requester positioned in that directory. Extremely useful once
  254.        you get used to this :^)
  255.      If you are running Workbench 2.0 PPShow will use the asl.library
  256.        instead of the arp.library (for the filerequester).
  257.      Fixed serious bug: memory wasn't freed when an IFF error occured.
  258.      No longer tries to display small brushes (intuition doesn't like very
  259.        small screens :( )
  260.  
  261. *****************************************************************************
  262. VERSION 2.0
  263.  
  264.      PPShow requires Kickstart 2.0 to run.  Sorry to all the 1.2 and 1.3
  265.        users, just consider this program as another reason to upgrade :-)
  266.  
  267.      Filerequester from arp.library is no longer supported.
  268.      PPShow now uses reqtools.library (also by moi) for its requesters.
  269.        Among other things this means a much better filerequester than
  270.        before (with a buffer).  Asl is no longer used, sorry Commodore :-)
  271.      Printing of screen removed, has anybody ever used this ? :-)
  272.      Improved command line format, follows AmigaDOS standard. (old option
  273.        '-h' is no longer supported!).
  274.      IFF decrunching rewritten in assembly: much faster and shorter.
  275.      Shows pictures saved in DPaint with stencil on. In other words: supports
  276.        IFF picture masking.
  277.      No longer quits when you press any key, you have to press 'Q', CTRL-C,
  278.        or right mouse button; CTRL-D aborts PPShow and breaks scripts.
  279.      Color cycling is now automatically switched on (except for brushes).
  280.      Mouse pointer visibility can be toggled.
  281.      Possibility to automatically stop displaying after a specified number
  282.        of seconds.
  283.      Many new command line options: change display resolution, switch off
  284.        overscan, disable auto-cycling, etc.
  285.      Several options may be set using Workbench tooltypes.
  286.      From Workbench, if you single-click PPShow and shift double-click a
  287.        drawer icon, PPShow will open up the filerequester in that drawer.
  288.      If you use 'PPShow <file>' or extend-select <file> from Workbench and
  289.        you invoke the filerequester, it will be positioned in the directory
  290.        <file> is in.
  291.      The filerequester will appear on the picture screen if possible.
  292.      Canceling the filerequester no longer quits PPShow.
  293.      The filerequester will filter out the .info files.
  294.      Can be used as a simple slideshow program: supports wildcards and
  295.        multiple files on command line, also possible to loop the slideshow.
  296.        Picture switching is double buffered.  Multiple extended selection
  297.        from Workbench is also supported.
  298.      Overscan now done using Kickstart 2.0 display clips.
  299.      Supports all new ECS display modes (ECS Denise only) and all monitors.
  300.      Will switch to PAL or NTSC monitor automatically (ECS Agnus only).
  301.      PPShow will now show very large screens without problem, AUTOSCROLL is
  302.        switched on so the screen automatically scrolls when you move the
  303.        mouse pointer off the edge.
  304.      Screen no longer has an invisible dragbar.  Use meta-dragging (left
  305.        Amiga key + mouse) to drag the screen.
  306.      Directories are expanded to their full pathnames on startup.
  307.      PPShow now returns a returncode of 20 in case of an error or if ended
  308.        by CTRL-D.
  309.      Error reporting improved: when started from CLI, errors are printed
  310.        on the console; when started from Workbench, a requester is used.
  311.      All these great new features and PPShow grew only about 1K in size :-)
  312.  
  313. *****************************************************************************
  314.  
  315. PPShow 2.0 written by Nico François (Yes, Nico is my first name :-)
  316.  
  317. (c) 1991 Nico François
  318.  
  319.                                    //
  320.                        Thanks to \X/ Amiga for being the best computer ever!
  321.  
  322.